GtkListBox: improve the docs

The documentation was not really clear about ::row-selected
not working for multi-selection.

diff --git a/gtk/gtklistbox.c b/gtk/gtklistbox.c
index 62aefe58683def07597dc901545e1f810a40929f..1b0fd12ba6f0014883b151093a01c10ca73aefe4 100644 (file)
--- a/gtk/gtklistbox.c
+++ b/gtk/gtklistbox.c
@@ -395,7 +395,9 @@ gtk_list_box_class_init (GtkListBoxClass *klass)
    * The ::row-selected signal is emitted when a new row is selected, or
    * (with a %NULL @row) when the selection is cleared.
    *
-   * Also see #GtkListBox::selected-rows-changed.
+   * When the @box is using #GTK_SELECTION_MULTIPLE, this signal will not
+   * give you the full picture of selection changes, and you should use
+   * the #GtkListBox::selected-rows-changed signal instead.
    *
    * Since: 3.10
    */